home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / utilities / mkptc017.lha / MakePatch / MakePatch.dok < prev    next >
Encoding:
Text File  |  1993-03-30  |  4.7 KB  |  117 lines
  1.  
  2.                     $VER: MakePatch_Anleitung v1.0 (11-Feb-93)
  3.                     ==========================================
  4.  
  5.         COPYRIGHT
  6.  
  7.     Patch'Em  und  MakePatch  sind  Public  Domain.  Alle  Rechte  an   den
  8. Programmen und Routinen sind völlig frei. Da ich wahrscheinlich nicht  mehr
  9. an diesem Projekt weiterarbeiten werde, sind Ergänzungen sehr erwünscht.
  10.  
  11.  
  12.         WHAT IS IT
  13.  
  14.     Als Programmierer hatte ich oft  folgendes  Problem:  Ich  hatte  einen
  15. winzig kleinen Fehler in meinem Programm gefunden und behoben.  Obwohl  die
  16. Änderung vielleicht nur zwei Byte betrug  (Assemler  :->),  mußte  ich  das
  17. ganze Programm oder gar das ganze Archive an meine Betatester schicken, was
  18. in die Fernzone auf die Dauer etwas teuer wird.
  19.  
  20.     Das hat mit MakePatch jetzt ein Ende. MakePatch erkennt die geänderten,
  21. eingefügten  oder  gelöschten  Byte  im  File  und  speichert   nur   diese
  22. Informationen ab, sodaß meist ein sehr kleines "Patchfile" entsteht.  Unter
  23. Verwendung dieses Files kann man mit Patch'Em aus  der  alten  Version  die
  24. neue patchen. Dabei  ist  dies  nicht  auf  Programme  beschränkt,  sondern
  25. funktioniert natürlich mit jeder Datei, sei es Grafik, Text, Sound oder ein
  26. LhA-Archive.
  27.  
  28.  
  29.         INSTALLATION
  30.  
  31.     Als  erstes  muß  die  PTool.Library  ins  "LIBS:"-Verzeichnis  kopiert
  32. werden, vorher tut MakePatch garnichts. Wenn sie diese Library  bereits  in
  33. ihrem System installiert haben,  dann  können  sie  über  das  CLI-Kommando
  34. "Version" die Versionsnummer der Library herausfinden, und  so  die  neuere
  35. von beiden installieren.
  36.  
  37.     Ist die Library erstmal installiert, muß nur noch MakePatch  selbst  in
  38. den Kommandopfad kopiert werden, üblicherweise "C:".
  39.  
  40.  
  41.         USAGE
  42.  
  43.     MakePatch muß alle benötigten Informationen während des  Programmstarts
  44. über die Kommandozeile übergeben bekommen. Mit "MakePatch ?" kann man  sich
  45. die Usage-Template im  üblichen  OS-Format  als  Gedächtnisstütze  anzeigen
  46. lassen.
  47.  
  48. Im einzelnen bedeuten die Argumente folgendes:
  49.  
  50.     Original/A - Dies ist der  Name  und  Pfad  der  ursprünglichen  Files.
  51.                  Dieser Parameter muß angegeben werden!
  52.  
  53.     NewVersion/A - Dies ist der Name und Pfad der neuen Version, in der die
  54.                  Änderungen enthalten sind, die  gegenüber  dem  "Original"
  55.                  erkannt werden  sollen.  Dieser  Parameter  muß  angegeben
  56.                  werden!
  57.  
  58.     PatchFile - Dies ist der Filename unter dem das Patchfile abgespeichert
  59.                  werden soll. Wird dieser Parameter nicht  angegeben,  legt
  60.                  MakePatch die Datei unter dem Namen der neuen Version plus
  61.                  die Endung ".ptch" ab.
  62.  
  63.     Wenn man MakePatch nun mit den  richtigen  Parametern  aufgerufen  hat,
  64. gibt das Programm eine Statusmeldung aus,  in  der  nochmal  steht,  welche
  65. Files jetzt gerade bearbeitet werden. Sind alle Dateien erfolgreich geladen
  66. erscheint ein Progress-Indikator, der dem  Benutzer  sagt,  wie  lange  das
  67. Erstellen des Patches noch dauern kann.
  68.  
  69.     Für gewöhnlich geht das Erstellen von Patches  sogar  bei  sehr  großen
  70. Files sehr schnell, da der Algorithmus jedoch sehr aufwendig ist,  kann  es
  71. doch mal einige Zeit dauern, besonders wenn sehr viele Änderungen  am  File
  72. vorgenommen wurden. Der Prozess läßt sich jedoch  praktisch  jederzeit  mit
  73. CTRL/C unterbrechen.
  74.  
  75.  
  76.         ERRORS
  77.  
  78.     Im Archive befindet sich einige  Catalogfiles,  die  zur  PTool.Library
  79. gehören. Dieser werden ab Workbench V2.1 benötigt, welche  die  Möglichkeit
  80. bietet, Programme zu lokalisieren. Sollten sie  WB  2.1  nicht  installiert
  81. haben, können sie dieses Verzeichnis getrost vergessen (:->) und müssen mit
  82. englischen Texten vorlieb nehmen.
  83.  
  84.  
  85.         NOTES
  86.  
  87.     MakePatch bildet über alle Files Prüfsummen  und  speichert  diese  ins
  88. Patchfile mit ab. So kann Patch'Em erkennen, wenn der  Benutzer  nicht  die
  89. richtige Originalversion hat, oder wenn ein interner Fehler auftritt.
  90.  
  91.  
  92.         FUTURE
  93.  
  94.     Im Moment bietet MakePatch  nicht  die  Möglichkeit,  den  eigentlichen
  95. Patch auch durchzuführen, dazu wird noch Patch'Em benötigt. In der nächsten
  96. Version wird diese Funktion in MakePatch eingebaut sein. Patch'Em wird dann
  97. eine spezielle Version sein, die bereits unter OS 1.2  läuft,  denn  bisher
  98. brauchen ja beide Programme OS 2.04!
  99.  
  100.  
  101.     SYSTEM REQUIREMENTS
  102.  
  103.     MakePatch läuft nur unter Kickstart V37.xxx oder höher. Weiterhin  wird
  104. die PTool.Library benötigt.
  105.  
  106.  
  107.         THE AUTHOR
  108.  
  109.     Wer irgendwelche Kommentare oder Fragen an mich hat, der  kann  mich  -
  110. vorzugsweise über E-Mail - unter folgenden Adressen erreichen:
  111.  
  112.     Snail-Mail: Peter Simons        E-Mail: simons@peti.GUN.de (Usenet)
  113.                 Europaring 20
  114.                 D-5300 Bonn 1       Voice: Tel. 0228 / 746061
  115.                 Germany
  116.  
  117.